• ClearTaskList Method
• CopyContentsTo Method
• CopyItemTo Method
• CopyNewContentsTo Method
• DeleteItem Method
• FullPath Method
• GetItem Method
• ItemExists Method
• ItemModifiedTime Method
• ItemSize Method
• ListItems Method
• Open Method
• Purge Method
• ReferenceItem Method
• SaveItemToFile Method
• SetItem Method
• SetItemAsync Method
• SetItemFromFile Method
• SetItemFromFileAsync Method
• SetItemPermissions Method
• WaitForAllSetItemCallsToFinish Method
• WriteItemToStream Method

A5Storage::SubContainer ReferenceItem Method

Syntax

Arguments

BYREF ItemA5Storage::DataItem

A DataItem that will contain the reference to the requested object.

TargetPathCharacter

The object to retrieve.

Returns

ResultLogical

Returns .T. if the operation succeeds, otherwise .F. (see .CallResult for additional error information.)

Description

Creates and returns a reference to an item within the container.

Discussion

You must DIM Item before making the call. No data is actually read until you ask for it.

Example

dim CallResult as CallResult
dim SubContainer as A5Storage::SubContainer = null_value()

CallResult = A5Storage::SubContainer::Open(SubContainer, "Provider='Disk';Container='c:\A5Webroot';", "logs")
? CallResult.Success
= .T.

dim Item A5Storage::DataItem = null_value()
? SubContainer.ReferenceItem(Item, "MyObjectName")
= .T.